583 



Book 6 
Utility Programs 

Peripheral Interchange Program 
(PIP) 

Source Compare 
(SRCCOM) 

Binary Compare 
(BINCOM) 

DECtape Utility Program 
(TENDMP) 



File Update Generator 
(FUDGE 2) 

Cross-Reference Listing 
(CREF) 

Global Symbol Cross Reference List 
(GLOB) 
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PERIPHERAL INTERCHANGE PROGRAM (PIP) 

PIP transfers data files from any standard l/O device to any other standard I/O device and, additionally, 
performs simple editing and magnetic tape control functions. PIPl , a compact version of PIP, performs 
a subset of PIP functions. PIP handles all data formats, and eliminates the need for a satellite computer 
to handle off-line data conversions. 



Requirements 

PIP Minimum Core: 3K 

Equipment Handled: 



Additional Core: IK if disk is one of the I/O devices; 
any core above that required is used 
for extra I/O buffers . 

DECtape, disk, magnetic tape, paper tape reader, 
paper tape punch, card reader, line printer, and 
teletype. 



PIPl Minimum Core: IK 



Equipment Handled: 



Additional Core: Any core greater than IK is used 
for extra input buffers. 

DECtape, disk, magnetic tape, paper tape reader, 
paper tape punch, card reader, line printer, and 
teletype. 



Initialization 



.RPIP; or ._R PIPl; 



Loads PIP (or PIPl) into core. 

PIP is ready to receive a command; an asterisk 
is typed after each requested action has been 
completed. 
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Commands 
General Command Forrrtal- 

destinaHon-dev:fi lename ,ext ^source-devjfi lename .ext , . . .soorce-n ^ 

destinaHon-dev: The destination device, to which the data is to be 

source-dev: transferred; the source device (s), from which the 

data is to be read 

NOTE 

If logical device SYS (the CUSP device) is a 
DECtape, it must not be modified using the 
/R or /b switches or any other request re- 
quiring it to be initialized for input and out- 
put at the same time . 



DTAn: 


(DECtape) 


PTR: 


(paper tape reader) 


PTP: 


(paper tape punch) 


DSK: 


. (disk) 


CDR: ' 


(card reader) 


MTAn: 


(magnetic tape) 


LPT: 


(line printer) 


TTY: or 


(Teletype) 


TTYn: 





If more than one file is to be transferred from a magnetic 
tape, card reader, teletype, or paper tape reader, dev: 
is followed by a comma for each file after the first; 
these devices can also be followed by * or *. * to in- 
• dicate all files are to be transferred. 

fi lename. ext (DSK: and DTAn: only) 

The filename and filename extension to be assigned 
to the file on the destination device; the filename 
# and filename extension of the file(s) to be read from 

the source device. 

An asterisk can be used for source files as follows. 

filename.* - Transfer all files having the 
specified filename. 

*.ext - Transfer all files having the 

specified extension. 

*.* - Transfer all files. 

* -Transfer all files with null 

extensions. 
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The destination descriptors and the source 
descriptors are separated by the left arrow 
symbol (*-) . 



Disk File Descriptor Format 



DSK:fiIename.ext [ pro j, prog] <protection > 



[ proj ,prog ] 



<protectiori > 



Project-programmer number assigned to the disk 
area to be used, if other than the user's project- 
programmer number. 

Protection value to be assigned to the destination 
file. If omitted, the standard protection is assigned 



NOTE 

Standard protection (055) designates that the 
owner is permitted to read or write, or change 
the protection of, the file while others are 
permitted only to read the fi le . 



Standard Assumptions 

Unless otherwise changed by switches, all files which are on directory devices and which have a file- 
name extension of .REL, .SAV, .DMP, or .CHN are copied in binary; all other files are assumed to be 
in ASCII line mode. AAagnetic tape files, unless otherwise changed by switches, are read in odd parity 
and written in odd parity at 556 bpi . 



Examples 



Command 



Function 



^R PIPJ 
+LPT:«-DTA1 :FILE1 J 

*LPT:*-DTA1 :* ) 

*DTA2 :FILE2*-DTAI :FILE1 -IMP J 



Loads and starts PIP. 

Transfer the file named FILEl from DTAl 
to the line printer. 

Transfer all files with null extensions from 
DTAl to the line printer. 

Transfer the file named FILEl .TMP to DTA2 
and give it the name FILE2. 
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Command 



Function 



*DTA2:F-ILE3-DTA1 :FILE1>FILE2 ; 



Transfer the files named FILEl and FILE2 
from DTA1 to DTA2, combining tHem as one 
file under the name FILE3. 



*DTA2:FILE3-DTA1 : F I LE 1 . DTA3 :F ILE2 ^ Transfer the RIe named FILEl from DTAl and 

the file named FILE2 from DTA3 to DTA2, 
combining them as one file under the name 
FILE3. 



*DSK:FILE1-MTA1 :} 



*DSK:FILE1 <177>-MTA1 :* ) 



*DSK:FILE1 CI :»3:*-MTA1 :> ) 



*PTP:«-PTR 



*tCi 



Transfer the next file from the present 
position of MTA1 to the user's area on the 
disk, call it FILEl, and assign the standard 
protection of 055 . 

Transfer all files from MTAl (starting at 
the current position of the read head) to the 
user's area on the disk, combining them into 
one file called FILEl , and assign protection 
177. 

Transfer the next two files from the present 
position of MTAl to area 1 ,3 on the disk, 
combining them into one file called FILEl , 
and assign the standard protection (055) , 
Transfer five files from the paper tape reader, 
combining them as one file on the paper tape 
punch . 
Return to AAonitor. 

Dot indicates that user is at Monitor level . 



Switches 



Nonmagnetic-tape switches, when used, are preceded by a slash (if more than one is specified, they 
may be enclosed by parentheses instead) and can appear anywhere in the command string; however, if 
the command string contains commas, the switches must be specified prior to the first comma. 

Magnetic tape switches are enclosed by pare^^•^^*»ses and must appear immediately following the device 
or file to which they refer. 

Switches are used to specify: 



a. Particular files for transferra! or deletion; 

b. Editing; 

c . AAode of transfer; 

d. Directory manipulation (DECtape and DSK); and 

e. Magnetic tape control . 
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A listing of PIP switches can be obtained by typing 
*output-clev:/Q"^ } 
where output -dev: may be either LPT: or TTY: 



PIP Switch Options 



Switch 



Meaning 



Line blocking 

Process file in Binary mode. 

Suppress trailing spaces and Convert multiple spaces to tabs. 

Delete the file. 

Treat Ending (card) columns 73 through 80 as spaces. 

List the directory in short form for DSK: or DTAn: only. (Filenames 

and extensions only.) Useful when disk directory cannot be listed with /L sw. 

Ignore I/O errors. • 

Process file in image binary mode. 

Process file in Image mode. 

List the directory (DSK: or DTAn: only) 

Magnetic tape switches . A string of one or more magnetic tape 
switches begins with an M and is enclosed in parentheses. 

*nA Advance the tape n files. E Even parity. 

Mark End of File. 

Skip to logical end of Tape. 



#nB 


Backspace the tape n filet. 


F 


#nD 


Advance the tape n records . 


T 


#nP 


Backspace the tape n records . 




2 


200 bpi density. 




5 


556 bpi density . 




8 


800 bpi density . 


U 


A 


Advance tape one file. 


W 


B 


Backspace tape one file. 





Rewind tape and Unload 
Rewind the tape , 



NOTi 

MTA switches always apply to the device or file immedi- 
ately preceding the switches . MTA switches should be 
used only in specific situations . For a more detailed treat- 
ment, see PIP Programmer's Reference Manual. 
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PIP Swifch Options 



Switch 



Meaning 



N 
O 
P 

Q 
R 
S 

T 
U 
V 
X 
Y 



Delete the sequence Numbers from a file. 

Same as /S switch except sequence numbers are incremented by 1 (One). 

FORTRAN output file format assumed as input. Convert format control 
characters for line Printer listing. 

Print this list of switches . 

Rename the f i le . 

Add Sequence numbers to the file or resequence a file already containing 
Sequence nunr^ers; Sequence numbers are incremented by TO. 

Suppress Trailing spaces. 

Copy blocks 0, 1 and 2 of a DTA file. Commonly used to transfer TENDMP, 

Count unmatched angle brackets < >. 

Copy specified files only. 

Perform a RIM DTA to PTP conversion . 

Destination format: 



Source extension: 
.RTB 

.SAV 
.RMT 



RIM Loader, RIM 1 OB File, 
XFERWD 

RIMIOB File only. 
RIM10 



Zero out the directory (DTAn: or DSK: only). 



NOTE 

Switches A, B, N, S, and Z are available for use in PIPl 
Y is an optional switch obtained by setting RIMSW= 1 at 
assembly time (see PIP, OPR file for explanation of PIP 
assembly and loading procedures). 



59t 



Examples 



^R PIP ; 
*DSK:/X-DTA1 :*.+ ) 

*DSK: (DX)<-DTA1 :FILE1 ^*.REL ) 

*MTA2 :/S-CDR: 5 
*LPT:/P«-DTA1 :,FILE1 ; 

*DTA2:FILE1 /I-PTR: } 



*TTY:/L*-DTA1 : } 

rnnnn FREE BLOCKS LEFT J 
Lfilename.ext no. blocks creation date 



Load and run PIP. 

Transfer all files from DTAl to DSK, 
keeping them separate and retaining 
their fi lenames . 

Transfer all files, except FILE! and 
any files with the extension. .REL, 
from DTAl to DSK, keeping them 
separate and retaining their filenames. 

Transfer a file from the card reader to 
MTA2 and add sequence numbers. 

Take FILEl (a FORTRAN output print 
file), interpret the carriage control 
characters, and print the file using specified 
carriage control , 

Initialize both DTA2 and the paper tape 
reader in image mode and transfer one. 
file from the paper tape reader to DTA2, 
calling it FILEK 



List the directory of DTAl on the 
teletype . 



*DTA1 :/Z<- ) 

*MTA2 : CM8E)«-MTA1 : (ME8) ^ 

*MTA2 : (MW)*- } 

*LPT:«-MTA1 : CM2W), (MA):.> ; 

*MTA1 : (M#4A)-CDR : } 



Zero the directory of DTAl . 

Transfer a file frbm MTAl to MTA2 in 
800 bpi , even parity mode . 

Rewind MTA2. 

Set MTAl to 200 bpt , odd parity, 
rewind the tape, and transfer the first, 
third, fourth, and fifth files to the 
printer . 

Advance MTAl four files before trans- 
ferring a file from the card reader. 

Return to the Monitor. 



y 
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Diagnostic Messages 



PIP Diagnostic Messages 



Message 


Type 


Meaning 


?4K NEEDED 


S 


4K is not currently available but is needed 
when a disk is present in the system , 


7DECTAPE I/O ONLY 


S 


I/O device for copy block 0.(/U) must be 
a DECtape . 


7DEVICE devtDOES NOT EXIST 


I/O 


Either device name has been misspelled 
or there is no such device . 


7DEVICE dev:NOT AVAILABLE 


I/O 


The device has been assigned to another 
job. 


9DIRECTORY FULL 


FR 


There is no room for an entry in a DEC- 
tape directory. 


DISK DIRECTORY READ 


I/O 


This message is nonfatal if the /G switch 
is used; otherwise, it is fatal and is pre- 
ceded by a ?. A second message follows 
(see Table 6-3). 


?DISK OR DECTAPE INPUT REQUIRED 


I/O 


This command requires a directory device 
for input . 


?DTATO PTPONLY 


RIM 


DTA input and PTP output must be speci- 
fiedforA- 


FAILURE DURING (A/A,/D,/Ry 
REQUEST 


S 


Each file requested does exist, but one or 
more was unavailable for processing. This 
message is never fatal . 


9FILE filename .ext ILLEGAL 
EXTENSION 


RIM 


Extension for // request must be . RMT , 
.RTB,or.SAV. 


7FILE filename .ext ILLEGAL FORMAT 


RIM 


1 . Zero-length file; or 

2. Requisite job data info not available; or 

3. Block overlaps previous block (RIM 10) or 

4. EOF found when data was expected, or 

5. A pointer word was expected but not 
found in the source file. 


?filename.ext (3) FILE WAS BEING 
MODIFIED 


FR , 


Disk file named is currently being processed 
by another job .^ 


?filename.ext (0) FILE WAS NOT 
FOUND 


FR 


Filename. ext not found during LOOKUP. 
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PIP Diagnostic Messages 



Message 



?filename.ext(0) ILLEGAL FILE NAME 



?fTIename.ext(l) NO SUCH PROJECT- 
PROGRAMMER NUMBER 

INPUT DEVICE dev: FILE filename. ext 



?LINE TOO LONG 

?LOAD POINT BEFORE END OF 
(MB) OR (MP) REQUEST 



?NO BLOCK COPY 

?NO FILE NAMED filename.ext 

?NO FILE NAMED QPIP 

OUTPUT DEVICE dev: FILE filename.ext 

?PIP COMMAND ERROR 



?filename.ext (2) PROTECTION FAILURE 

?fi lename .ext (4) RENAME 
FILENAME ALREADY EXISTS 

?fi lename .«xt (5) RENAME ERROR 

?fi lename. ext (6) 

?fi lename. ext (7) 



Type 



FR 



FR 
I/O 

S 
S 

c 

FR 

S 

I/O 

c 



FR 

FR 

FR 

I/O 

I/O 



Meaning 



Indicates that 

1 . No filename was specified for DTA 
output file; or 

2 . A rejedt occurred on a /R request 
for disk file; or 

3. Illegal filename was specified for a 
/R request on DTA. 

The project -programmer number specified 
for a DSK file is incorrect. 

This message is nonfatal if the /G switch 
is used; otherwise, it is fatal and is pre- 
ceded by a ?. A second message follows 
(see Table 6-3). 

A line >140 characters was detected in 
the source file. 

Load point on a magnetic tape file has 
been reached before the tape has been 
backspaced the number of files or records 
specified in (M#nB), (M^nP). 

/U given but PIP assembled without 
provision for this . ^ 

No such file found during PIP directory 
search . 

The data file for the /Q switch is not 
available. 

Followed by a second message (see Table 
6-3). 

1 . Illegal format for command string; or 

2. Nonexistent switch requested; or 

3 . Filename .ext other than 

* (or * . *) requested for a non- 
directory device; or 

4. The illegal switch combination RX. 

Same as FAILURE DURING . . . message 
except that the processing halts. 

Tried to rename file with already 
existing name . 

LOOKUP or ENTER not done. 
Error not yet defined . 
Error not yet defined. 
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PIP Diagnostic Messages 



Message 


Type 


Meaning 


9TERMINATE A MAX of 999 FILES 
^ PROCESSED 


S 




The A switch specified for nondirectory 
device source files has processed the 
maximum number of files (999) . 


?TOO MANY REQUESTS FOR dev: 


C 




Conflicting parity/density requests have 
been given for a magnetic tape. 


?TRY PIP 


. 






During a PIPl run, a switch or function 
which is not present in PIPl has been 
requested . 




NOTES 




/ 


All fatal diagnostic messages are 
mark(?). 


preceded by a question 




Message types are: 






C Command string error 

FR File reference error 

I/O I/O error 

RIM ReoG^in Mode specification error 

S Other types of errors . 



Table 6-3 
Secondary PIP l/O Diagnostic Messages 



Message 


Device 


Meaning 


BINARY DATA INCOMPLETE 


PTR 


Length of block disagrees with word 
count (nonfatal if the /G switch has 
been specified) . 


BLOCK TOO LARGE 


DTA 


DTA link number >1101g. 


CHECKSUM OR PARITY ERROR 


All 


Read or write error (nonfatal if the /G 
switch has been specified) . 


INPUT BUFFER OVERFLOW 


All except DTA 


Block too large for buffer (nonfatal if the 
/G switch has been specified). 


DEVICE ERROR 


All 


The data control unit has detected the 
loss of data (nonfatal tf the /G switch has 
been specified). 
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Secondary PIP I/O Diagnostic Messages 



Message 


Device 


Meaning 


PHYSICAL EOT 

WRITE (LOCK) ERROR 

--■/ 

7-9 PUNCH MISSING 


MTA 

DTA,DSK,MTA 

CDR 


The end of tape has been reached (nonfatal 
if the /G switch has been specified) . 

Attempt has been made to write on a write- 
lockedfile. 

Binary card lacks 7-9 punch (nonfatal if the 
/G switch has been specified). 



IK Version of PIP (PIP!) Limitations 
The following limitations apply to PIP! : 

a. Z dnd MW requests ignore all source devices. 

b. B switch included since REL,SAV,DMP, and CHN files are not automatically copied in 
36-bit bytes . 

c. Error messages assume all I/O devices are DECtape. 

d. Neither project -programmer numbers nor protection can be specified for disk files. 

e. The * cannot be used for filenames or extensions. 

f . SAV files cannot be successfully copied with PIP! . 

Monitor Commands 

The following Monitor commands perform PIP-type operations. 



Desired Result 



To type the contents 
of a file on theTTY. 

To list the contents of 
a file on the line printer. 

To type the directory 
of a device on the TTY. 

To list the directory of 

a device on the line printer. 



Monitor Commond 
^TYPE dev:filename.ext; 

^LIST dev:filename.ext^ 

_.DIRECTdev:; 

.DIRECT dev:/L; 



Equivalent CUSP Commands 

_.R PIP J 

*TTY: "^dev: filename .ext; 

^R pip; 

*LPT: -^devifilename.ext^ 

_^R pip; 

*TTY: -dev:/L; 

TrPIP; 

*LPT: -dev:/L; 
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Desired Result 
To delete a file. 

To rename a fi le . 



Monitor Command 



DELETE devifilename.ext 



RENAME dev:newfn=oIdfn 



Equivalenr CUSP Commands 

'^RPip; 

*dev:fi lename .ext/D-^ } 
_.R PlPi 
*dev:newfn/R -^oldfn ^ 



NOTE 
If dev: is omitted in the Monitor commands, DSK: is assumed. 
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FILE UPDATE GENERATOR (FUDGE2) 

FUDGE2 updates Hies containing oneor more relocatable binary programs, and permits the user to 
manipulate individual programs v/ithin program files. 



Requirements 

Minimum Core: 
Additional Core: 
Equipment: 



2K 

Dynamically allocates its buffers to utilize ds much core as Is made available 

Two input devices, one for the master file and one for the transaction file; 
one output device for the updated file. The input device(s) and output 
device can be the same device (DSK:). The two input devices can be the 
same DECtape. 



Initialization 



RFUDGE2; 



Loads the File Update Generator program 
FUDGE2 is ready to receive a command. 
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Commands 

General Command Format 

new-dev:filename.ext-^master-dev:filename.ext <prognamel ,progname2, . .progname > , ) 

Iransaction-devtfilename .ext < prognamea,prognameb, — prognomez > (commands) $ 

new-dev: The destinaHon device, on which the updated 

file is written. 

DTAn: 
DSK: 
MTAn: 
PTP: 



master-dev: 



The device containing the file to be updated, 

DTAn: 
DSK: 
MTAn: 
PTR: 



NOTE 



tronsaction-dev: 



If more than one file Is to be transferred 
from a magnetic tape or paper tape 
reader, dev: Is followed by a colon ( : ) 
for each file after the first. 

The device containing the file of programs to 
be used In the updating process. 

DTAn: 
DSK: 
MTAn: 
PTR: 

NOTE 



If more than one file is to be transferred 
from a magnetic tape or paper tape 
reader, dev: is followed by a colon ( : ) 
for each file after the first. 

More than one transaction device, with its 
associated filenames and program names, can 
be specified in certain instances (see 
Switches). 

filename. ext (DSK: and DTAn: only) The filename. ext of the new, updated version 

of the program file. 

The filename. ext of the program file con- 
taining the programs to be deleted, replaced, 
or augmented . 
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The filename .ext of the program file con- 
taining the programs to be used in performing 
additions or replacements to the master file. 

If no .ext is given, .REL is assumed. 

< progname, > (DSK: and Program names must be specified in the same 

DTAn: only) relative order in which they qppear in the 

file. 

Program names are grouped together within 
angle brackets <> and are separated by 
commas. 

If it is desired to append, replace, insert, 
or extract all programs within a file, only 
the filename. ext need be specified. 

Program names cannot be specified for the 
output file. 

The new output file is separated from the 
master and transaction files by the left 
arrow symbol ( •^). 



Command Codes 

The function to be performed by FUDGE2 is selected by including one of the following command codes 
at the end of the command string. Command codes are enclosed within parentheses (or preceded by a 
slash) and one (and only one) must appear in every command string. 

FUDGE2 Command Codes 



Command 



Meaning 



Append one or more programs from the transaction file(s) to the master file 
and write out the new file. The command string is as follows: 

new-file -^ master-file, transaction -file, (A) $ 

Delete one or more programs from the master file and write out the new 
file. The files (and programs) to be deleted are listed after master-dev:. 
The command string is as follows: 

new-file ^ master-file<file(s) to be deleted>(D) $ 

Extract the specified files (and programs) from one or more input files and 
create a new output file. If program names are not specified for a file, 
the entire file is extracted. The command string Is as follows: ' 

new-file *- masterfi!e<file(s) to be extracted >(E) $ 
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FUDGE2 Cocnmond Codes 



! 

h Gom.Ticnd 


Meaning 


1 

I 


Insert programs from one or more transaction files onto the master file and 
write out the new file. The programs from the transaction file(s) are in- 
serted immediately before the specified programs on the master file. The 
command string is as follows: 




new-file -^ master-fi!e<file(s) to be inserted before >, transact ion-file(s) (I) $ 


L 


list all relocatable programs within a file and print the listing on the output 
device, which must be either T7Y: or LPTt The command string is as follows: 




listmg-device -^ file(L) $ 


R 


Replace the named program(s) on the master file with the named program (s) 
from the transaction file, and wr^te out the new file. The command string 
is as follows: 




new-file *- master-file <file(s) to be replaced>,transaction-fi!e<replacement 
file(s)>(R) $ 


NOTE 


Only one operation can be specified per command 
sfnng. Thus, to delete a file and replace some other 
one, two commend strings are required. 



Examples 



^R FUDGE2; 
*LPT:«-DTA1 :LIB40CL) 



s; 



*DTA2:LIB4AA ^DTAl :LIB40 <EXP .2> (D )$ J 



*DSK:LIB4BB-D7A2:LIB4AA <EXP .3 ^EXP .3C>> } 
D7A1 :F1 <EXP.3A>EXP.3B>CR) S; 



*PTP:*-DSK:LIB4BB^DTA4:SCIENC<C0SRTE>/A 



List all relocatable programs (.REL) 
from the file LIB40, located on 
DTAl on the line printer. 

Delete the program EXP. 2 from the 
file LIB40 on DTAl; write the new 
file on DTA2 and call it UB4AA.REL. 

Replace programs EXP. 3 and EXP.3C 
located In file LIB4AA on D7A2, with 
programs EXP.3A and EXP.3B in 
File F4 on D7A9; write out the new 
LIB4AA file on disk and call it 
LIB4BB. 

s; Append the program COSRTE, located 
in file SCIENC on DTA4, to the file 
LIB48B on disk; write out the updated 
LIB4BB file on the paper tape punch. 
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*DTAi :NFILE-DSK:MFILE<M1 :»M2>M3>M4>^ 

DTA3:TF-ILEA<TA1,>TA2> J 
DTA4:TFILE8<TB1 >TB2>/I S} 



*DTA1 :NFILE-DSK:MFILE<M1 ^A2,M3jWA>) 

DTA3:TFILEA^ 

DTA4:TFILEB/I S} 



Ci 



Insert into MFILE the programs TAl 
and TA2 from TFILEA and TBI and 
TB2 from TFILEB. Create NFILE with 
the following order: 
TAl ,M1 ,TA2,M2,TB1 ,M3JB2,AA4 

Insertion is on a one-to-one basis. If 
there are more programs to be inserted 
than specified programs before which 
they are to be inserted," the extra files 
are ignored.' 

However, in this example (where 
TFILEA and TFILEB contain the pro- 
grams TAl and TA2 and TBI and TB2, 
respectively) create an NFILE With the 
following order: 
TAl ,TA2,MI ,TB1 ,TB2,M2,M3,M4 

Return to the Monitor . 



Sy/ itches 

Switches are used to manipulate file directories ai^d to position magnetic tape . They are either preceded 
by a slash or enclosed in parentheses and Can appear anywhere in the command string. 



FUDGE2 Switch Options 



Switch 


Meaning 


B 


Backspace magnetic tape one file. 




K 


Advance magnetic tape one file. 




W 


Rewind magnetic tape. 




Z 


Clear directory of destination device (DTAn: 


only). 



Examples 



iR fudges; 

*DTA2:TESTA-MTA1 :(WK>^MTA2: :CZA) ij 



*tC^ 



Clear the directory of DTA2; rewind 
MTAl and advance the tape one file; 
append the first two program files from 
MTA2 to the second file on MTAl and 
write out the resultant file on disk, 
calling it TESTA. 

Return to the Monitor. 
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Diagnostic Messdges 



FUDGE2 Diagnostic Messages 



Message 



Meaning 



7CANNOT DO l/O AS REQUESTED 



?DEVICE ERROR ON OUTPUT DEVICE 
?DIRECTORY FULL ON OUTPUT DEVICE 

?ENTRY BLOCK TOO LARGE, 
PROGRAM xxxxxx 



?FUDGE SYNTAX ERROR 



?x IS AN ILLEGAL CHARACTER 



?xIS AN ILLEGAL SWITCH 



?dev NOT AVAILABLE 



?NOT ENOUGH ARGUMENTS 



?dev filename ,ext progname NOT FOUND 



?PROGRAM ERROR WHILE RESETTING 
AAASTER DEVICE 



Input cannot be performed on one of the devices 
specified for input (it is an output only device) or 
output cannot be performed on the device 
specified for output . 

A write error has occurred on the output file. 

No more files can be added to the file directory 
on the output device (the directory is full). 

The entry block of program xxxxxx is too large 
for the FUDGE2 entry table, which allows for 
32 entry names. FUDGE2 can be reassembled 
with a larger table. 

The command string is illegal (e.g., the left 
drrow was omitted, a program name was specified 
for the output file, or some meaningless command 
was entered). 

An illegal character has been encountered in the 
command string . 

An illegal or otherwise meaningless switch has 
been encountered in the command string . 

The device either does not exist or has been 
assigned to another job. 

An insufficient number of files of one type or 
another has been specified . 

Either the filename. ext or the program name was 
not found on the device (or In the file) specified. 
If a progrqpi name is printed, this may indicate 
that the program names in the command string 
appear in a sequence different from their sequence 
within the file; thus, the program may actually 
exist in the named file but was missed because of 
the incorrectly entered sequence in the command 
string. 

Either FUDGE2 cannot find the master device or 
cannot find the program name on the master 
device. 
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FUDGE2 Diagnostic Messages 



Message 


Meaning 


?TOO MANY FILE NAMES OR 
PROGRAM NAMES 

?TRANSMISSION ERROR ON 
INPUT DEVICE dev 

?UNEQUAL NUMBER OF MASTER 
AND TRANSACTION PROGRAMS 


i 

More than 40 program names or file names were 
given in a command string. Break tfie job into 
several segments and rerun . 

A transmission error has occurred while reading 
data from device dev . 

An unequal number of master and transaction 
programs (or files) has been specified with a 
Replace request. 
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CROSS-REFERENCE LISTING (CREF) (VERSION CREF.V32 AND LATER) 

CREF produces a sequence -numbered assembly listing followed By one fo three tables, one showing cross 
references for all operand-type symbols (levels, assignments, etc.)/ another showing cross references 
for all user defined operatcws (macro calls, OPDEFs etc.)/ and another (if the proper switch is specified) 
showing the cross references for all op codes and pseudo-op codes (MOVE,XALL, etc.)- A number sign 
(#) appears on the definition line of all symbols. The input to CREF is a modified assembly listing file 
created during a Macro-10 assembly or FORTRAN IV compilation when the /C switch is specified in the 
command sh-ing . 

CREF provides an invaluable aid for program debugging and modification. -^ 



Requirements 
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Minimum Core: 
Additional Core; 
Equipment: 



2K 

Takes advantage of any additional core available, as necessary. ^ 

One input device (normally disk) which contains the modified assembly 
listing file; one output device (normally the line printer) for the listing. 



Initialization 



RCREFJ 



\ Loads the Cross-Reference Listing program into 

core . 

The program is ready to receive a command. 



Commands 



General Command Format 



output -de v: *-input-dev:filename,ext 
output -dev: 



input-dev: 



filename. ext (DSK: or DTAnronly) 



The device on which the assembly listing and 
cross-reference tables are to be printed (LPT: is 
assumed if device is not specified). 

The device on which the modified assembly list- 
ing was written during Macro-10 assembly (DSK: 
is assumed if device is not specified). 

The filename and filename extension of the modi- 
fied assembly listing file (CREF.LST is assumed 
if filename. ext is not specified). 

The output device and the input device are 
separated by the left arrow symbol . 



Disk File Command Format 

DSK :f i lename . ext Cproj ,prog] 
[pro i, prog] 



Project-programmer number assigned to the disk 
area to be searched for the source file if other 
than the user's project -programmer number. 



Examples 



6()6 



^R MACRO i 

*PTP: :»/C-DTAl :TXCALC^ 

'thfrf ar^.no errors^ 
program break is 003771 j 
jk core used j 

.R CREF/ 



*tC J 



Loads the AAacro-10 Assembler info core. 

Assembles the program TXCALC from DTAl; writes 
the object program coding on the paper tape punch; 
writes a modified assembly listing on DSK: (as- 
sumed) and assigns it the filename CREF.LST. 



Return to the Monitor. 

Loads CREF into core. 

Selects the default assumptions of: 
output-dev: LPT: 

input-dev: DSK: 

filename, ext CREF.LST 

Return to the Monitor. 



Switches 

Switches are used to specif/ such options as magnetic tape control and list selection. All switches are 
preceded by a slash (/). 



CREF Switch Options 



Switch 


Meaning 


A 


Advance magnetic tape reel by one file. /A may be repeated. 


B 


Backspace magnetic tape reel by one file. /B'may be repeated. 


K 


Kill listing of references to basic symbols (labels, assignments, etd.). 


M 


Suppress listing of references to user-defined operators (Macro calls, 
OPDEFs,etc.). 


O 


Allow listing of references to machine and pseudo-operation codes 
(MOVE, XALL, etc.). 


R 


Requests (by typing out RESTART LISTING AT LINE:) the line number at 
which the listing is to Restart. (Such action might be necessary if the 
line printer ran out of paper, or jammed, etc.) The user types the line 
number followed by a can-iage return. 


S 


Suppress program listing (list only the selected tables). 
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CREF Switch Options 



Switch 


Meaning 


T 
W 

Z 


Skip to logical end of magnetic Tape. 

ReWind magnetic tape. 

Zero the DECtape directory (DECtape must be output only). 



Examples 



^ cref; 

*/M*-MTAl :/W } 
*pTA5:SAVEl /Z- } 



Loods CREF into core. 

Rewind MTAT and process the first file, listing 
only the cross references for operand-type sym- 
bols (labels, assignments, etc.). 

Process the file named CREF. LST in the user's 
area of disk; write the program listing and 
operand-type cross references on DTA5 and cal 
the file SAVE!. 

Return to Monitor 



Diagnostic Messages 



CREF Diagnostic Messages 



Message 


Meaning 


?dev NOT AVAILABLE 
7CANNOT ENTER FILE fnmel.ext 
7CANNOT FIND FILE fnme.ext 
7COMMAND ERROR 
? DATA ERROR DEVICE dev: 
TERROR READING COMMAND FILE 
7IMPROPER INPUT DATA 
?INPUT ERROR ON DEVOCE dev: 
7INSUFFICIENTCORE 


Device is assigned to another job. 

DTA or DSK directory is full; file cannot be entered. 

The file cannot be found on the device specified. 

Error in last command string entered. 

READ or WRITE error. 

Disk data error while reading nnnCRE.TMP (see below). 

Input data not in CREF format. 

READ error has occurred on the device. 

Additional core is required for execution but none is 
available from Monitor. 
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AAonitor Commands 

CREF-format listing files generated by COMPILE, LOAD, EXECUTE, and DEBUG commands (using the 
/CREF switch) can be printed on the line printer by typing 

XREF } 

The CREF command will print out all listing files that are specified in the CCL command file, 

nnn CRE.TMP (where nnn is the user's job number). After completion of this operation, nnnCRE.TMP 

is deleted to preclude the listing files being listed again by the next CREF command. 
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GLOBAL SYMBOL CRQSS REFERENCE LIST (GLOB) VERSION #002 OR LATER 

GLOB reads multiple binary program fifes produced by Macro and F40 and generates an alphabetic 
cross^eferenced list of all global 'symbols encountered. 



Requirements 



Minimum Core: 
Additional Core; 
Equipment: 



2K 

Requests additiorKil core from the Monitor as required. 

An input device for each binary file to be scanned for global symbols and 
one or more list! rvg devices for output. 



Initialization 



rglob; 



Loads the Global Cross-Reference Listing 
program. 

The program is ready to receive a command. 



Commands 



Input Command 

dev:filename.ext, . . . . filename. ext,dev:filename.ext 
dev: 



.filename.ext,. .^ 

The device(s) containing the binary program files 
to be scanned. 

MTAn: (magnetic tope) 

DTAn: (DECtape) 

DSK: (disk) 

PTR: (paper tape reader) 
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filename. ext (DSK: and DTAn: only) 

The filename and filename extension of each binary 
program which resides on either disk or DECtape. . 



Output Command 
devr-^S „ 



dev: 



The device on which the global symbol listing is to 
be printed. 

LPT: (line printer) 

TTY: (Teletype) 

Other output devices can be specified if desired. 

More than one output command can be given if it 
is desired to produce several types of listings on 
several different devices. Each new output com- 
mand is typed after the previous request has been 
completed. 



Examples 



iP glob; , ' 

*DSK:F1 ,F2>DTA3 rCALCl /calC5 } "^he binary program fiJes to be scanned are Fl and 
- F2 on DSK , and CALC 1 and CALC5 on DTA3 . 

All global symbols in these programs are to be 

listed on the printer. Printed with each symbol 
*LPT : «- S i °^^ '^^ value, the name of the program in which 

~ — it was defined, and the names of all the programs 

in which it was referenced (i.e. , declared 

external). 

*rc J Return to the Monitor. 



Switches 

The switches available in GLOB are used to determine the types of global symbols to be listed on each 
of the specified output devices. If ng switches are typed, pi I global symbols are listed. There are also, 
three separate switches (L, M, and X) which act independently. 

All switches are either preceded by a slash or enclosed in parentheses and can appear anywhere in the 
output command string. However, only the most recently specified switch (except L, M, or X, which 
always take effect) Is in effect at any given time. 



GLOB Switch Options 



Switch 


Meaning 


A 


All global symbols are to be listed (assume if no switch is given). 


E 


List erroneous (multiply defined or undefined) symbols only. 


F 


List fixed (nonrelocatable) symbols only. 


L 


Turn on Library Search Mode (that is, only scan programs if they contgin 
globals previously defined and not yet satisfied). 


M 


Turn off Library Search Mode. 


N 


List only those symbols which are never referred to. 


R 


List relocatable symbols only. 


S 


List multiply specified (i.e. , symbols defined in more than one program, 
but with non -conflicting values) only. 


X 


' Omit printing of listing title when output is other than TTY. Include 
printing of listing title when output is TTY. 




NOTE 




Normally, the title is printed on all devices except the 
Teletype. 



Examples 



.R GLOB ; 

*DTA1 :TEST1 .REL^^SUBRTE^DSK : AR ITHl » } The binary programs to be scanned are 



*SC lENC^RETEST ) 

*LPT:*-/R S2 
*TTY:-/E S } 

U EXTSYM 

*tc ; 



SU3RTE 



files TESTl.REL and SUBRTE on DTAl, 
and ARITH1, SCIENC, and RET EST on 
disk. 

List only relocatable symbols on the 
printer. 

Printer listing is completed. Enter com- 
mand to print all erroneous symbols on 
the Teletype. 

(U = Undefined; EXTSYM Is the unde- 
fined symbol; SUBRTE is the program in 
which EXTSYM appears.) 

Return to the Monitor. 
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Diagnostic Messages 



GLOB Diagnostic Messages 



Message 


Meaning 


?commaSjd syntax error 


An illegal command string has been entered. 


7DESTINATION DEVICE ERROR 


An I/O error has occurred on the output device. 


?DIRECTORY FULL 


No more files can be added to the directory of 
the output device. 


?dev NOT AVAILABLE 


The device either does not exist or has been as- 
signed to another job. 


?filename,ext NOT FOUND . 


The filename. ext cannot be found in the directory 
on the device specified . 


7TABLE OVERFLOW - CORE UUO 
FAILED TRYING TO EXPAND TO xxx 


GLOB requested additional core from the Monitor, 
but none was available. 



GLOB Error Flags 



Flag 


Meaning 


M 


Multiply defined symbol (all values are shown). 


N 


Never referred to (i.e. , was not declared external in an/ of the binary 
programs) . 


S 


Multiply specified symbol (i.e., defined in more than one program, but 
with non-conflicting values). In the listing, the name of the first pro- 
gram in which the symbol was found is followed by a plus sign. 


U 


Undefined symbol. 
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SOURCE COMPARE (SRCCOM) (VERSION 013) 

SRCCOM compares, line by line, two versions of a source file coded as lines of ASCII characfers and 
outputs any differences . 



Requirements 

Minimum Core: 
Additional Core: 



Equipment: 



2K 

The minimum core allows for comparing files with minimal differences, 
SRCCOM automatically requests more core from the Monitor when it 
needs it. Major differences can usually be handled in 3K, but for 
comparing two completely different files, enough core is required to 
store all of both files simultaneously. 

'User teletype for control; two input devices for the two files to be 
compared; one output device for listing the differences. 



Initialization 



.R SRCCOM 



Loods the Source Compare routine. 

Source Compare is ready to receive a command 



614 



Commands 

General Command Format 

list-devifilename.ext-^input 1-dev:fllename.ext, input2-dev:filename.ext ^ 

li$t-dev: The device on which the differences are to be 

listed. 

LPT: (line printer) (Any device 

TTY: (teletype) that can output 

MTAn: (magnetic tape) ASCII characters) 

DTAn: (DECtape) 

DSK: (disk) 

input -dev: The devices on which the two source files to 

be compared are located . 

MTAn: (magnetic tape) (Any device 

DTAn: (DECtape) that can input 

DSK: (disk) ASCII characters) 

PTR: (paper tape reader) 

filename. ext(DSK: and DTAn: only) 

The filename and extension of either of the input 
source files. 

The filename and extension to be assigned to the 
output list file . (SRCCOM.LST is assumed if no 
filename is specified.) 

The output device is separated from the input source 
file devices by the left arrow symbol . 

Default Conditions 

TTY: is assumed as the output device if no other device is specified. 
DSK: is assumed as both input devices if no other devices are specified. 

A dot is necessary in filename *2 to explicitly indicate a null extension if the extension for filename #1 
is not nul 1 . 

Example: 

LPT: -DRAn:FORSE.MAC,DSK:FORSE.(FORSE has a null extension.) 

The filename and extension for input file *1 is assumed to be the filename and extension for filename#2 
unless another filename or extension is specified. 
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The file^name and extension for the output file is assumed to be SRCCOM.LST unless another filename 
or extension is specified . 

Switches 

Switches are used to specify the manner in which the comparison is to be done. All switches consist 
of a single character preceded by a slash (/), anywhere in the command string. 



Source Compare Switches 



Switch 


Meaning 


/B 

/c 
/s 

/n 


Enables the comparing of Blank lines. Normally blank 
lines are completely ignored. 

Comments (all text on a line after a semicolon) are 
ignored. /C will not cause a line consisting entirely 
of a comment to become a blank line which will be 
ignored. /S is also implied. 

Spacing (spaces and tabs) is ignored . 

(n = 1 , 2 ^ . . . ,9) A match consists of n lines . (n is 
normally 3) n successive lines must be found identical 
in the two input files for a match in the two files to be 
found. When a match is found, all differences between 
the current match and the previous match are listed . 
The first line of the match is also listed to make the 
location in the file easier to find . 



Examples 



^R SRCCOM } 

*LPT:-DTA2 .-SOURCE. 001 ^DTA3: 
SOURCE. 002 J 



*LPT:-DSK:TRY1 ^DSK:TRY2 } 



*tC } 



Compare the source file SOURCE. 001 
on DTA2 with the source file 
SOURCE .002 on DTA3 and list all 
differences on the line printer. 

Compare the two files, TRY! and TRY2, 
both of which are on the disk, and list 
the differences on the printer. 

Return to the Monitor. 
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Example of Source Compare Output 



SRCCOM output 


Frie 1 input 


File 2 input 




page 1 


page 1 


FILE!) FILE#1 






FILE 2) FILE #2 


FILE^l 


FILE #2 


1)1 1 FILE#1 


A 


A 


ttl) A 


B 


B 


**** 

2) It FILE*2 


C_ 


C 


D 


^-'^ G 


t2) A 


E ^^-- 


H 


*************** 


F ^^""^ 


I 


1)lt D 


G 


J 


1) E 


H ' 


^-^ 1 


1) F 


I ^"^ 


2 


1) G , 


^^^-"^ 


3 


**** 


K 


^^ ^- "^ 


2)1 1 G 


L ^-"' 


^' 


*************** 


M-"""' 


/ 


1)1^ K 






1) L 
1) M 










l)2t N 


page 2^ 


page 2 


**** 






2)1 t 1 • 


N 


N 


2) 2 


O 


O 


2) 3 


P 


P 


2)2 1 N 


Q 


Q 


*************** 


R 


R 


l)2t w 


S 


s 


**** 

2)2^ 4 


T 


T 


U 


U 


2) 5 
2) W 


y 


V 


w^--^^:" 


4 


*************** 


X 


^^-^^-5- 




Y 


W 




Z 


X 
Y 
Z 



tThese numbers in the SRCCOM listing are page numbers referring to the input files. 

' TA line identical to both input files is listed to help find the location of the differences within 
the two fi les . 
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Diagnostic Messages 



Source Compare Diagnostic Messages 



Message 


Meaning 


?2K CORE NEEDED AND NOT 
AVAILABLE 

7BUFFER CAPACITY EXCEEDED 
AND NO CORE AVAILABLE 

7COMMAND ERROR 
7DEVICE dev:NOT AVAILABLE 

7FILE 1 READ ERROR 

7FILE 2 READ ERROR 

7INPUT ERROR - filename .ext 
-' FILE NOT FOUND 

?NO DIFFERENCES ENCOUNTERED 

70UTPUT DEVICE ERROR 
70UTPUf INITIALIZATION ERROR 


SRCCOM needs 2K to initialize lO devices 
and the core is not available from the Monitor 

The buffer is not large enough to handle the 
number of lines required for looking ahead and 
no more core is available from the Monitor. 

Error in last command string entered. 

One of the input devices cannot be initialized; 

generally, the device either does not exist or 

has been assigned to another job . .-' 

An error has occurred on the first input device 
specified in the command. 

An error has occurred on the second input device 
specified in the command. 

The specified filename cannot be found. 

No differences were found between the two 
source files. 

An error has occurred on the output device . 

The output device cannot be initialized; the 
device either does not exist or has been assigned 
to another job, the device is not an output device 
or the filename could not be entered on thes device. 
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BINARY COMPARE (BINCOM) 



BINCOM compares, word by word, fwo versions of a binary (.REL) program file and outputs any 
differences. 



Requirements 
Minimum Core: 

Additional Core: 
Equipment: 



IK if output device rs other than DTAn:, MTAn:, or DSK:; 
otherwise 2K . 

See Minimum Core, 

Two input devices for the two files to be compared; one output 
device for listing the differences. Both input files can be on 
disk . 



Initialization 



/ 
.R BINCOM; 



Loads the Binary Compare routine . 

Binary Compare is ready to receive 
a command . 



Commands 

General Command Format 



!ist-dev:filename.ext '^inputl-dev:filename,ext, input2-dev:fllename.ext^ 



list-dev: 



input! -dev: 



The device on which the differences are to be listed. 

LPT: (line printer) 

TTY: (teletype) 

MTAn: (magnetic tope) 

DTAn: (DECtape) 

DSK: (disk) 

If list-dev:filename.ext "^is omitted, TTY: is assumed 

The devices on which the two binary files to be 
compared are located 

L)TAn: (DECtape) 

DSK: (disk) 

CDR; (card reader) 

PTR: (paper tape reader) 

MTAn: (magnetic tape) 



filename. ext (DSK: and DTAn: only) 



The filename and extension of either of the input 
binary files. 

The filename and extension to be assigned to the 
output list file. 
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Command 



FuncHon 



NOTE 
If .exf is omitted, null extension is assumed, 



The output device is separated from the input 
binary file devices by the- left arrow symbol . 



Examples 



iR BINCOM } 



*LPT:-DSK:PR0G1 .REL^ Compare "the binary program file PROGl.REL in the 

DTAl :PR0G1 .REL ; user's area of the disk with a binary program file, 
PROGl.REL, on DTAl, and list all differences on 
the line printer. 

NO ERRORS ENCOUNTERED j Nq differences were found between the two files. 



D'l A 1 : B I NA , DTA2 : B I MB ) 



loc file! -word fiIe2-wordXOR 



*tc 5 



Compare the binary program file BINA on DTAl 
with the binary program file BINB on DTA2 and 
list all differences on the teletype . 



NOTE 

.REL is assumed as the extension name for both 
BINA and BINB. 

Return to the Monitor . 



Diagnostic Messages 



Binary Compare Diagnostic Messages 



Message 


Meaning 


7COMMAND ERROR 

7DEVICE dev: NOT AVAILABLE 

?END OF FILE PHASE ERROR 


Error in last command string entered. 

Device has been assigned to another [ob or does 
not exist . 

One input file is longer than the other. 
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Binary Compare Diagnostic Messages 



Message 


Meaning 


?FILES BEING COMPARED ON 
SAME INPUT DEVICE 


Files cannot be compared from the same input 
device unless that device is DSK: . 


7INPUT ERROR filename. ext 
NOT FOUND 


The file specified could not be found on the 
input device. 


NO ERRORS ENCOUNTERED 


No differences were found between the two 
binary program files. 


?OUTPUT INITIALIZATION ERROR 


The file cannot be entered. 



Error Differences 

Whenever a difference is encountered between the two files being compared, a line is printed on the 
listing device in the following for mot: 



octal loc. 



file! -word file2-word 



XOR of both words 
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TENDMP IS a utility program, used to save and restore core images on DECtape. It is 
compatible with the PDP-10 time-sharing system's directory-structured DECtape format, and with the 
format of a SAVE file. 

TENDMP operates in executive mode only, and will run on a PDP-6 or a PDP-10 computer 
with either a TD-10 or 551/136 DECtape system. (If a PDP-10 is used, the KE-10 Extended Order 
Code Option is required.) 

1. TENDMP FUNCTIONS 

TENDMP has the following functions: ' 

1) Selection of DECtape unit. 

2) Listing of directory of DECtape. 

3) Loading a program into core , ' 

4) Zeroing of directory. 

5) Merging a program from tape into core, leaving other areas untouched. 

6) Dumping nonzero regions of core onto tape. 

7) Deleting a particular file from a tape. 

8) Specifying a starting address to be saved with a core image. 

9) Starting a program loaded from tape. * 

All of the above functions can be performed by commands from the console Teletype, or by 
calling TENDMP as a subroutine and providing a command string in core. 

2. COMMANDS^ 



2.1 Unit Selection 



To select a unit, type n($) where n is a number from through 7 (unit means 8,'^ as usual) 



In the command formats which follow, certain conventions apply. 

a. The symbol ($) represents the ALTMODE character (ASCII code 033, 175, or 176). ALTMODE 
echoes back as a dollar sign ($), 

b. Alphabetic characters in commands and filenames can be typed in either upper or lower case; they 
are considered to be in upper case. 

c. Filenames consist of a 6-character name and a 3-character extension. A space (not a period) 
separates the name from the extension. All printing characters are legaMn filenames. If the space 
and extension are omitted, a null extension is assumed. SAVE files created by Monitor normally, 
have the extension "SAV." 

d. The character RUBOUT or DELETE erases the entire command currently being typed. 
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This command causes TENDMP to read the directory block from DECtape unit n into core, anc\ 
defines that unit as the current unit. This unit and directory are remembered in core, and need only 
be specified once during d sequence of operations, perhaps including running other programs, if the 
storage in core from 37177 through 2^57 is not disturbed. 

2.2 Listing a File Directory ? 

To list the file directory of the current unit, type 

F(D 
The name and extension of each file will be listed. 

2.3 Loading and Starting a Program 

To load and start a program, type the filename followed by a carriage return. If the ex- 
tension is null, it may be omitted. 
Examples: 

file ext^ 
or 

file^ 
This command causes core to be cleared from location 40 through location 37176, the pro- 
gram to be read from tape, and the program to be started at th^ address which was specified when the 
program was dumped (see below). 

2,3.1 Variations on the Above Loading - To load a program without start'wig it, that is with control 

remaining in TENDMP, type: 

U®file^ 
This command clears core from 40 through 37176, and loads the prograhn into core. 
The clearing of core can be. inh it ''-id, and a program merged with existing core, as follows: 

M(DfiIe^ 
This causes only those areas for which information is present on tape to be modified. For 
instance, 

M®EDDT SA\^ 
would allow EXEC DDT to be used to examine a current core image, or to share core with a maintenance 
or diagnostic program. 

Location 40 is cleared before the merge is done. 

2 

All addresses given in this document assume the 16K version of TENDMP, Translation of these figures 

for other versions is a simple matter, \ 
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2.3.2 Starting the Program - The command to go to the current starting address (that last specified 

by loading or merging a program or set by the operator (see below)) is: 

2.4 Zeroing a Directory 



To clear the directory of the current unit, type 
To put a clear directory on a virgin DECtape, type 



The first command is necessary to specify the current unit, and It will read the contents of 
the directory block Into core, even though the contents may be unspecified. However, the 2(Dcom- 
mand will discard that Information, create a legitimate, clear directory in core, and write It on the - 
tape. 

A clear directory reserves blocks 1 , 2, and 144 (octal) with file code 36, and clears all 
filenames. 

The last word in the directory, which is the tape identifier. Is not cleared. If a tape does 
not have an identifier, one may be added manually by depositing It in location 37376, and then per- 
forming a Z(f), D(D, or K($) command. 

2.5 Dumping a Program Onto Tape 

When a program is dumped, a starting address is dumped with It, Therefore, a starting ad- 
dress must be specified before dumping. 

The current starting address Is set each time a program is loaded from tape; it may be (eft 
alone if the same address Is to be dumped. Otherwise, the command 

r<D 
where n is the new current starting address Is used. 

Since this Is the same formaV as the unit selection command, the restriction is imposed that 
the starting address.must be greater than seven. In fact, nt should be 20 or greater, since the accumu- 
lators are all used by TENDMP, and are not dumped with a file. ' 

Dumping a file Is accomplished as follows: 

D(Dfile extJ 
This causes the contents of core, from location 20 through 37174, to be dumped with the name "file ext" 
on the current unit, and with the current starting address. Sequences of two or more zeroes are omitted 
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from the file. If a file of that name already exists, it is superceded. The correct core size Informatior 
is put into the directory, but the contents of the dote field are unpredictable. The directory is then 
written onto the tape. Control remains in TENDMP. 

2.6 Deleting a File from the Tope 

To delete a specific file, type 

K(Dfileext^ 
The specified file will be deleted (killed) and the directory will be written back out onto tape 

3. DIAGNOSTIC MESSAGES 

As core space in TENDMP is at a premium, there is only one error indication - the Teletype 
bell Is rung. The user should then be able to diagnose the error by examining the last command typed 
and checking the list of possible errors given below. 

a. The directory may not have been read in from the DECtape as yet, or It may have been 
clobbered after being read in. 

b. The filename ext. specified In a K® L® or M® command cannot be found on the 
current DECtape. 

c. There Is no room either in the directory or on the DECtape to dump another f*le. In the 
latter case, the directory In core may be In an intermediate state, so that rereading the directory from 
tape by an n® command Is advisable. 

d. There are either no units or there Is more than one unit dialed to the current unit number. 

e. The wrlre-lock switch was on for a D®, K®, or Z® command. 

f. A tape read or write error occurred. 

g. The tape has run Into the end zone (position the tape manually If this Is the case). 

4. , TENDMP VERSIONS 

The user should be aware -that there are several versions of TENDMP and should check the 
label of the paper tape version to be used. for the following parameters: 

a. Which DECtape control is used - TD-10 or 551. 

b. What memory size Is handled. 16K or 32K are the usuaj cases. 

c. What paper tape format Is used - HRI (Hardware Readin Mode - also called RIMIOB) or . 
RIM (Readin Mode - read by a special subroutine located in the shadow accumulators on the PDP-6)- 
HRI Is~pref"errTd for PDP-10. 

The creation of these versions is explained In "Assembly Instructions" below. 
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5., ASSEMBLY INSTRUCTIONS 

Assembling a copy of TENDMP from the source is straightforward. The output is normally in 
RIMIOB format, and is, of course, absolute. 

The norma! assembly is for a 16K machine, and for the TD-10 DECtape control. 

Conditional assemblies are provided to modify the above standards. 

The normal assembly command string to MACRO is: 

*PTP:,LPT:'*-TTY:,DTAx:TENDMP.MAC^ 

To modify the standards, add some of the following at assembly time: 

MODE=l ;for551 control version. 

MODE (s normally zero, representing a TD 10 TENDMP. 

COI^E-1 ;for an 8K version 

CORE=4 ;for a 32K version 

CORE is normally 2, and is the number of 8K blocks of core for this version of TENDMP. 

DEFINE RIMIOB RIM ;for PDP-6 paper tape format 
Example: 



^PTP:, LPT: ^TTY:, DTAx: TENDMP .MAC J 
CORE-4J 

♦z ^ 



. END OF PASS 1 

6. STORAGE ALLOCATION 

TENDMP, when loaded, occupies the upper end of available memory. The figures below 
are given for a 16K memory; translation of these figures for other core sizes should be obvious. 

Locations Contents 

37175, 37176 Cleared 

37177 through 37376 Directory of the current DECtape 

37377 through 37757 Actual coding and temporary storage areas 

37760 through 37776 Area reserved for command string (not 

. modified) 

^^77 Byte pointer to the ASCII command string 

which may be rn locations 37760 through 
37776 

In addition to these locations, TENDMP also modifies the contents of all accumulators (location 
through 17). 
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Since the actual code occupies locations 37400 through 277 S7 , TENDMP can fit into two 
DECtape blocks and con therefore be located in and bootstrapped from blocks and 1 of a properly 
prepared DECtape, using the Hardware Readin feature of the PDP-lO/TD-10. 

TENDMP's starting address is 37400. 

7. GALLING TENDMP AS A SUBROUTINE 

TENDMP can be called from a program by the following procedure: 

Place a series of commands, in ASCII format, in the reserved core area (37760-37776), omit^ 
ting line feeds after carriage returns. Place a byte pointer to this command string in location 27777 
such that an ILDB Z7777 will retrieve the first character. Transfer to 37401 . The commands will be 
executed. If the last command does not cause a transfer out of TENDMP, a RUBOUT should be the last 
character. This causes a carriage return line feed to be typed out, and control to be switched to the 
Teletype. 

If an error occurs during these comhnands, the Teletype bell is rung, and control switches 
immediately to the Teletype. 



TENDMP Command Summary 



Operation 


Command 


Comments 


Select a DECtape unit, read in 
its directory, and designate it as 
the current DECtape. 


n® 


n must be in tKe range to 7. 


Zero the directory of the current 
DECtape J 


Z® ^ 


. 


Dump nonzero areas of core and 
the current starting address onto 
the current DECtape. 1 


D ® file ext^ 


The core image file is assigned 
the name "file ext." 


Specify a new starting address 
prior to dumping or before giving 
the G $ command. 


n® 


n is at least greater than 7 but 
should be greater than 17g. 


Clear core, load a program from 
the current DECtape, and start it. 


file ext^ 


"file ext" is the name of the, core 
image file to be loaded. 


Clear core, load a program from 
the current DECtape, but do not 
start it. 


L® file ext^ 




The /lew directory is written onto the DECtape . 


1 
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TENDMP Command Summary 



Opera Hon 


Command 


Comments 


Merge a program from the current 
DEOape; leave the remainder of 
core undisturbed. 


1 
MDfileext^ 




Go to the current starting address. 


G® 




Delete (kill) a file from the current 
DECtape.l 


K®file ext^ 




. List the file directory of the cur- 
' rent DECtape. 


f® 




The new directory is written onto the DECtape. 



CREDITS: 

The basic structure of TENDMP was suggested by 

MACDMP, a program written at the Project MAC PDP-6 

installation at MIT. This guidance is gratefully 

acknowledged. 
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ADDENDUM 
Post Assembly Instructions to Generate a Self Starting TENDMP 

When a paper tape TENDMP is assembled with MACRO (version 008) it is not self starting, 
i.e., after reading the paper tape the operator must depress the "CONTINUE" switch to commence 
operation at the CTY, 

In order to generate a self starting version from the assembler output: 

1. Lood a monitor with exec DDT 

2. Then load assembler paper tape of TENDMP (either 16K or 32K) 

3. Enter exec DDT (start at- 141) and type 

$L $ = ALT MODE 

37400O7757 t R tR = Control R 

37400$J ' * 

The above instructions pertain to 16K TENDMP, for the 32K version the first digit of each 

number will be 7 Instead of 3. 



